MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-13 10:52
태그:
#MCP #써드파티 #문서변환 #파일포맷

역링크

Pandoc

Pandoc

Pandoc MCP 서버는 Pandoc 도구를 사용하여 다양한 문서 형식 간 변환 기능을 제공하는 Model Context Protocol 서버입니다. 이 서버는 Markdown, HTML, PDF, DOCX, RST, LaTeX, EPUB 등 다양한 형식 간에 콘텐츠를 변환하면서 원래의 서식과 구조를 보존합니다.

특징

  • 다양한 형식 지원: Markdown, HTML, 일반 텍스트, PDF, DOCX, RST, LaTeX, EPUB 등 다양한 문서 형식 간 변환 지원
  • 서식 보존: 변환 과정에서 원래 문서의 서식과 구조를 보존
  • 유연한 입출력: 직접 콘텐츠를 입력하거나 파일 경로를 통해 변환 가능
  • 수식 지원: LaTeX 수식을 다양한 출력 형식(유니코드, Word 수식 객체, MathML 등)으로 변환
  • 인용 및 참고문헌 지원: 자동 인용 및 참고문헌 시스템 포함
  • 템플릿 시스템: 출력 문서의 외관을 사용자 정의할 수 있는 템플릿 시스템 제공

API

도구

문서 변환 도구

  • convert_contents: 한 형식의 콘텐츠를 다른 형식으로 변환합니다.
  • 입력:
    • content (문자열): 변환할 콘텐츠
    • from_format (문자열): 입력 형식 (예: 'markdown', 'html', 'txt')
    • to_format (문자열): 출력 형식 (예: 'html', 'markdown', 'pdf', 'docx')
    • output_file (문자열, 선택적): 출력 파일의 전체 경로 (PDF, DOCX, RST, LaTeX, EPUB 형식의 경우 필수)
  • 출력:
    • 변환된 콘텐츠 및 저장 파일 경로(해당되는 경우)

지원되는 형식

기본 형식 (파일 경로 선택적)

  • txt: 일반 텍스트
  • html: HTML 문서
  • markdown: Markdown 문서(CommonMark 및 GitHub 형식 포함)

고급 형식 (전체 파일 경로 필수)

  • pdf: PDF 문서 (TeX Live 설치 필요)
  • docx: Microsoft Word 문서
  • rst: reStructuredText 문서
  • latex: LaTeX 문서
  • epub: EPUB 전자책 형식

사용 방법

Pandoc MCP 서버를 사용하려면:

  1. 필수 요구 사항 설치:

  2. PDF 변환을 위해 TeX Live 설치가 필요합니다:

    • Ubuntu/Debian: sudo apt-get install texlive-xetex
    • macOS: brew install texlive
    • Windows: MiKTeX 또는 TeX Live 설치 필요 (https://miktex.org/ 또는 https://tug.org/texlive/)

  3. mcp-pandoc 설치: 

    # PyPI를 통한 설치
pip install mcp-pandoc

# 또는 Smithery를 통한 자동 설치 (Claude Desktop용)
npx -y @smithery/cli install mcp-pandoc --client claude

  4. Claude Desktop 구성: 

    {
  "mcpServers": {
    "mcp-pandoc": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-pandoc",
        "run",
        "mcp-pandoc"
      ]
    }
  }
}

사용 예시

마크다운을 HTML로 변환

Convert this markdown to HTML:

# My Document
This is a **bold** statement with *italics*.
- Item 1
- Item 2

마크다운을 PDF로 변환

Convert this markdown to PDF and save as /Users/username/Documents/document.pdf:

# My Report
## Executive Summary
This report highlights the key findings of our research.

## Methodology
We used various methods to gather data.

중요 사용 지침

  1. 파일 경로 요구 사항:
  2. PDF, DOCX, RST, LaTeX, EPUB 형식으로 변환할 때는 다음이 필요합니다:
    • 전체 디렉토리 경로
    • 파일 이름
    • 파일 확장자
  3. 예: /path/to/document.pdf 또는 C:\Documents\document.pdf

  4. 도구는 자동으로 파일 이름이나 확장자를 생성하지 않습니다.

  5. PDF 변환 요구 사항:

  6. PDF 변환을 시도하기 전에 TeX Live를 설치해야 합니다.

  7. TeX Live 없이는 PDF 변환이 실패합니다.

  8. 변환 후 파일 위치:

  9. 변환 성공 후 도구는 파일이 저장된 정확한 경로를 표시합니다.
  10. 경로가 지정되지 않으면 파일이 시스템 임시 디렉토리에 저장될 수 있습니다.
  11. 더 나은 제어를 위해 항상 명시적인 출력 파일 경로를 제공하세요.

개발 상태

mcp-pandoc은 현재 초기 개발 단계에 있습니다. PDF 지원은 개발 중이며, 기능과 사용 가능한 도구는 서버를 계속 개선함에 따라 변경 및 확장될 수 있습니다.

연결된 구성 요소

  • 현재 다른 MCP 구성 요소와의 직접적인 연결은 없습니다.